Skip to main content

Shop System ADMIN

Table of Contents​

What is Shop System Administration?​

The Shop System Administration features provide server administrators with comprehensive tools to configure, manage, and monitor the in-game economy. This includes setting up the server's own shop, overseeing player shops, and adjusting core system settings.

How to Access Shop System Administration​

To access the Shop System Administration menu, open the admin panel and locate "Player Shops Manager"

Admin Shop Menu Options​

Once you open the Shop System Administration menu, you will typically see these options:

  • Manage Server Shop: Configure the items and prices for the shop run by the server.
  • Manage Player Shops: Oversee and manage the shops created by individual players.
  • System Settings: Adjust global settings for the entire shop system.
  • Developer Menu: Access advanced tools, usually for debugging or system resets.

Manage Server Shop​

This section allows you to control what items the server sells and buys.

Add Item to Server Shop​

This feature lets you add items from your inventory to the server's shop, setting their prices.

  1. Select Item: You will be prompted to select an item from your current inventory that you wish to add to the server shop.
  2. Item Details:
    • Price to Buy: Enter the amount players will pay to buy this item from the server.
    • Price to Sell: Enter the amount the server will pay players to sell this item to the server.
    • Max Stock: Set the maximum quantity of this item the server will keep in stock. This can prevent unlimited buying from the server.
    • Min Stock: Set the minimum quantity of this item the server will aim to keep. This helps ensure items are always available.
    • Enabled: Toggle whether this item is currently available in the server shop.
  3. Confirm to add the item to the server shop listings.

Edit Server Shop Listings​

This allows you to modify or remove existing items from the server shop.

  1. Select Item: Choose an item from the list of currently listed server shop items.
  2. You can then adjust any of the details set during the "Add Item" process (Buy Price, Sell Price, Stock, Enabled status).
  3. You also have an option to Delete the item permanently from the server shop.

Manage Player Shops​

This section provides tools to oversee and assist with player-created shops.

Edit Player Shop Settings​

This allows you to view and adjust the settings for any individual player's shop.

  1. Select Player: Choose an online player from the list whose shop settings you wish to manage.
  2. You will then see options to edit that player's specific shop settings, similar to what a player sees in their "Your Shop" settings. This might include:
    • Changing their shop's description.
    • Toggling their shop's "Open" or "Closed" status.
    • Potentially adjusting their shop's inventory or linked chest settings (if applicable).

View All Player Shops​

This option displays a comprehensive list of all active player shops.

  • You can see which players have active shops.
  • Selecting a player's shop might allow you to view their current listings or earnings, or teleport to their shop's location (if configured).

System Settings​

This menu allows you to configure global aspects of the entire shop system.

  • Default Listing Fee: Set the default fee players must pay to list an item in their personal shop. This is a one-time fee per listing.
  • Max Player Shops: Determine the maximum number of personal shops any single player can create.
  • Max Player Shop Listings: Set the maximum number of items a player can list in their shop at one time.
  • Currency Objective Name: Define the name of the scoreboard objective used for the server's currency (e.g., "money", "coins"). This is crucial for the shop system to interact with the economy.
  • Currency Display Name: The name displayed for the currency in shop menus (e.g., "§eCoins", "§aMoney").
  • Linked Chest Shops Enabled: Toggle whether players can link their shop to a physical chest in the world for automatic inventory management.

Developer Menu​

This menu contains advanced tools, typically for debugging, maintenance, or emergency actions. Use these options with extreme caution.

  • Generate Security Code: Generates a temporary code. This might be used for advanced authentication or specific debugging procedures.
  • Reload Shop System: Reinitializes the shop system. This can be useful after manual data modifications or if the system seems to be malfunctioning.
  • Delete All Shops: This will permanently wipe all player shops and their data. Use only in emergencies or for complete server resets. This action is irreversible.
  • Give Money: Allows you to add a specified amount of money to any player's balance.

Important Notes for Administrators​

Money Objective​

The "Currency Objective Name" in System Settings must exactly match the name of your server's money scoreboard objective for the shop system to function correctly with player balances.

Item Serialization​

When adding items to the Server Shop, the system converts your physical items into data that can be stored. This ensures item properties (like enchantments, custom names, and lore) are preserved.

Player Balances​

The system interacts directly with the money objective you define to manage player transactions. Ensure your money system is robust and properly set up.

Security Code (Developer Menu)​

The "Generate Security Code" option is likely a security measure for critical operations. Do not share generated codes unless specifically instructed by a developer.